(MOT-4059) feat(registry): publish worker discovery tags by rohitg00 · Pull Request #512 · iii-hq/workers

rohitg00 · 2026-07-16T14:26:41Z

Summary

read optional discovery tags from each publishable iii.worker.yaml, normalize them, and include non-empty values in POST /publish
add focused search aliases to 42 registry-published workers while leaving acp and lsp untagged because they opt out of registry publishing
validate tag shape in PR checks and cover payload normalization, omission, and error cases

Blocked by

merge and release iii manifest support from feat(iii-worker): accept registry tags in manifests iii#1977
bump the pinned iii version in _publish-registry.yml from 0.17.0 to that release
merge and deploy the registry API migration/schema/persistence support for tags

Test plan

.github/scripts/tests: 117 passed
Ruff checks for changed Python scripts
all 42 tagged publishable manifests parse with lowercase, unique string tags

Fixes MOT-4059

Summary by CodeRabbit

New Features
- Worker manifests can now include optional tags, and the publish pipeline includes normalized tags in published metadata when non-empty.
- Many built-in worker manifests now declare tags for better categorization and discovery.
Bug Fixes
- Tag validation added: tags must be a list of strings; invalid formats now fail with clear errors.
Documentation
- Documented optional tags behavior (trimming, lowercasing, deduplication, and omission when empty).
Tests
- Added coverage for tag normalization and validation failure cases.

vercel · 2026-07-16T14:26:48Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
workers	Ready	Preview, Comment	Jul 20, 2026 3:09pm
workers-tech-spec	Ready	Preview, Comment	Jul 20, 2026 3:09pm

github-actions · 2026-07-16T14:26:55Z

skill-check — worker

0 verified, 46 skipped (no docs/).

Layer	Result
structure	✓
vale	✓
ai	✓
render	✓

Four for four. Nicely done.

coderabbitai · 2026-07-16T14:27:00Z

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 79cef01b-7dc7-49fc-9262-9bb99ad2727b

📥 Commits

Reviewing files that changed from the base of the PR and between 3a22324 and e5f6913.

📒 Files selected for processing (1)

fp/iii.worker.yaml

📝 Walkthrough

Walkthrough

Worker manifests now support optional tags. Validation enforces list-of-string values, publishing normalizes and conditionally emits tags, tests cover valid and invalid cases, documentation describes the contract, and numerous worker manifests add tag metadata.

Changes

Worker tag metadata

Layer / File(s)	Summary
Tag contract and validation `.github/scripts/validate_worker.py`, `.github/scripts/tests/test_validate_worker.py`	Worker validation rejects non-list tags and lists containing non-string entries; tests cover both invalid forms.
Payload normalization and documentation `.github/scripts/build_publish_payload.py`, `.github/scripts/tests/test_build_publish_payload.py`, `docs/architecture/iii-worker-yaml.md`, `docs/sops/release.md`	Publishing trims, lowercases, deduplicates, and omits empty tags; payload tests and release documentation cover the behavior.
Worker manifest tag adoption `*/iii.worker.yaml`	Worker manifests add categorization tags across integration, provider, storage, messaging, and automation workers.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant WorkerManifest
  participant validate_worker
  participant build_payload
  participant RegistryPayload
  WorkerManifest->>validate_worker: provide optional tags
  validate_worker->>validate_worker: validate list and string entries
  WorkerManifest->>build_payload: provide manifest metadata
  build_payload->>build_payload: normalize and deduplicate tags
  build_payload->>RegistryPayload: include non-empty tags

Suggested reviewers: andersonleal

Poem

A rabbit hops through YAML bright,
Tags tucked neatly left and right.
Trimmed and lowercase, clean and small,
The payload carries them all.
“Hop!” says Bun, “the workers know—
Their tidy labels help them grow!”

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: publishing worker discovery tags in the registry.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

Create PR with unit tests
Commit unit tests in branch feat/publish-worker-tags

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands.}

rohitg00 · 2026-07-16T14:41:44Z

@coderabbitai review

coderabbitai · 2026-07-16T14:41:49Z

✅ Action performed

Review finished.

Note: CodeRabbit is an incremental review system and does not re-review already reviewed commits. This command is applicable only when automatic reviews are paused.

Refs MOT-4059

vercel Bot deployed to Preview – workers-tech-spec July 16, 2026 14:27 View deployment

vercel Bot deployed to Preview – workers July 16, 2026 14:27 View deployment

rohitg00 changed the title ~~feat(registry): publish worker discovery tags~~ (MOT-4059) feat(registry): publish worker discovery tags Jul 16, 2026

rohitg00 marked this pull request as ready for review July 16, 2026 14:38

rohitg00 added 2 commits July 17, 2026 10:19

feat(registry): publish worker discovery tags

683a0ce

Refs MOT-4059

feat(provider-kimi): add registry discovery tags

3a22324

rohitg00 force-pushed the feat/publish-worker-tags branch from 4569e94 to 3a22324 Compare July 17, 2026 09:21

vercel Bot deployed to Preview – workers July 17, 2026 09:22 View deployment

vercel Bot deployed to Preview – workers-tech-spec July 17, 2026 09:22 View deployment

guibeira approved these changes Jul 17, 2026

View reviewed changes

sergiofilhowz approved these changes Jul 20, 2026

View reviewed changes

rohitg00 added 2 commits July 20, 2026 16:07

Merge remote-tracking branch 'origin/main' into feat/publish-worker-tags

3634915

feat(fp): add registry discovery tags

e5f6913

vercel Bot deployed to Preview – workers July 20, 2026 15:09 View deployment

rohitg00 merged commit 371b163 into main Jul 20, 2026
139 of 141 checks passed

vercel Bot deployed to Preview – workers-tech-spec July 20, 2026 15:09 View deployment

rohitg00 deleted the feat/publish-worker-tags branch July 20, 2026 15:09

rohitg00 mentioned this pull request Jul 20, 2026

feat(ci): require discovery tags on publishable workers #544

Merged

2 tasks

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

(MOT-4059) feat(registry): publish worker discovery tags#512

(MOT-4059) feat(registry): publish worker discovery tags#512
rohitg00 merged 4 commits into
mainfrom
feat/publish-worker-tags

rohitg00 commented Jul 16, 2026 •

edited by coderabbitai Bot

Loading

Uh oh!

vercel Bot commented Jul 16, 2026 •

edited

Loading

Uh oh!

github-actions Bot commented Jul 16, 2026 •

edited

Loading

Uh oh!

coderabbitai Bot commented Jul 16, 2026 •

edited

Loading

Review failed

Walkthrough

Changes

Sequence Diagram(s)

Uh oh!

rohitg00 commented Jul 16, 2026

Uh oh!

coderabbitai Bot commented Jul 16, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Uh oh!

Conversation

rohitg00 commented Jul 16, 2026 • edited by coderabbitai Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Blocked by

Test plan

Summary by CodeRabbit

Uh oh!

vercel Bot commented Jul 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Jul 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

skill-check — worker

Uh oh!

coderabbitai Bot commented Jul 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review failed

Walkthrough

Changes

Sequence Diagram(s)

Uh oh!

rohitg00 commented Jul 16, 2026

Uh oh!

coderabbitai Bot commented Jul 16, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

rohitg00 commented Jul 16, 2026 •

edited by coderabbitai Bot

Loading

vercel Bot commented Jul 16, 2026 •

edited

Loading

github-actions Bot commented Jul 16, 2026 •

edited

Loading

coderabbitai Bot commented Jul 16, 2026 •

edited

Loading

coderabbitai Bot commented Jul 16, 2026 •

edited

Loading